home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / DATABASE / DOCPROC1.ZIP;1 / SAMP-DOC.ZIP / TAPECOPY.DOC < prev    next >
Encoding:
Text File  |  1992-11-08  |  20.4 KB  |  257 lines
  1.                                                                                 
  2.                                                                                 
  3.                                                                                 
  4.                                                                                 
  5.                                                                                 
  6.                                                                                 
  7.                                                                                 
  8.                                                                                 
  9.                                                                                 
  10.                                                                                 
  11.                                                                                 
  12.                                                                                 
  13.                                                                                 
  14.                        *************************************                    
  15.                        *                                   *                    
  16.                        *        T A P E C O P Y            *                    
  17.                        *  ON THE MVS/XA OPERATING SYSTEM   *                    
  18.                        *                                   *                    
  19.                        *************************************                    
  20.                                                                                 
  21.                                                                                 
  22.                                                                                 
  23.                                                                                 
  24.                                                                                 
  25.                                                                                 
  26.                                                                                 
  27.                                                                                 
  28.                                                                                 
  29.                                                                                 
  30.                                                                                 
  31.                                                                                 
  32.                                                                                 
  33.                                                                                 
  34.                                                                                 
  35.                                                                                 
  36.                                                                                 
  37.                                                                                 
  38.                                                                                 
  39.                                                                                 
  40.                                                                                 
  41.                                                                                 
  42.                                                                                 
  43.                                                                                 
  44.                                                                                 
  45.                                                                                 
  46.                                                                                 
  47.                                                                                 
  48.                                                                                 
  49.                                                                                 
  50.                                                                                 
  51.                                                                                 
  52.                                                                                 
  53.                                                         John S. Ward            
  54.                                                           03/15/93              
  55.  
  56. EJECT                                                                           
  57.         The TAPECOPY procedure generates JCL to copy data sets on a library     
  58.     or foreign, standard or non labeled tape to a library or foreign,           
  59.     standard or non labeled tape.                                               
  60.                                                                                 
  61.         INVOL     - The volume serial number of the input tape.                
  62.                     Required                                                    
  63.                                                                                 
  64.         INLBL     - The label type of the input tape, SL or NL.                 
  65.                     Default: SL                                                 
  66.                                                                                 
  67.         INEXPDT   - The expiration date of the input tape.  See member          
  68.                     TMSINFO in in SYS.MVS.UPDATE for information about          
  69.                     expiration dates.                                           
  70.                     Default: 99000                                              
  71.                                                                                 
  72.         OUTVOL    - The volume serial number of the output tape.                
  73.                     Default: none, Required if OUTEXPDT is 98000                
  74.                                                                                 
  75.         OUTLBL    - The label type of the output tape, SL or NL.                
  76.                     Default: SL                                                 
  77.                                                                                 
  78.         OUTEXPDT  - The expiration date of the output tape.  See member         
  79.                     TMSINFO in in SYS.MVS.UPDATE for information about          
  80.                     expiration dates.                                           
  81.                     Default: 99000                                              
  82.                                                                                 
  83.         CNTL      - The fully qualified data set name of a table describing     
  84.                     the input tape data sets.                                   
  85.                     Default: none, Required if 98000/NL INVOL                   
  86.                                                                                 
  87.         DSN       - The data set name of the 1st data set on the tape           
  88.                     Required if INEXPDT = 98000 and no CNTL                     
  89.                                                                                 
  90.         FSQN      - The file sequence numbers of the data sets to copy.         
  91.                     FSQN must be enclosed in quotes if specified.               
  92.                     Default: all files on input tape                            
  93.                                                                                 
  94.         HIQUAL    - The hi-level qualifier for the output tape data set         
  95.                     names.                                                      
  96.                     Default: USERID                                             
  97.                                                                                 
  98.         MIDQUAL   - The mid or 2nd level qualifier for the output tape data     
  99.                     set names.                                                  
  100.                     Default: none                                               
  101.                                                                                 
  102.         OUTLST    - Flag that instructs TAPECOPY to place listing of the        
  103.                     tape in HIQUAL.TCZZZ999.OUTLST(Linvol)                      
  104.                     Default: off                                                
  105.                                                                                 
  106.         SUB       - Flag that instructs TAPECOPY to submit the Tapecopy         
  107.                     job from the generated JCL in :                             
  108.                     HIQUAL.TCZZZ999.TAPECOPY(TCinvol).                          
  109.                     Default: off                                                
  110. EJECT                                                                           
  111.        If the input tape is a library (99000) tape the user may build a         
  112.     control file or they may submit a run sheet to PCG.  If the input tape      
  113.     is a private (98000) standard labeled tape the user may run TAPECOPY        
  114.     themselves without a control file.  If the input tape is a private non      
  115.     labeled tape the user must supply a control file.  TAPECOPY will always     
  116.     use a control file if it is supplied.  There are 13 parameters to           
  117.     TAPECOPY, but in most cases default values will be used for all but a       
  118.     few parameters.                                                             
  119.                                                                                 
  120.     LIBRARY TAPES                                                               
  121.                                                                                 
  122.        If the input volume is a library tape , there are two options.  The
  123.     user may submit a run sheet to the I/O window to request that PCG           
  124.     (Production Control Group) run the procedure.  The run sheet should         
  125.     specify all parameters the user wishes passed to the TAPECOPY procedure     
  126.     including HIQUAL.  PCG will run the TAPECOPY procedure which will place     
  127.     the desired JCL in:                                                         
  128.                                                                                 
  129.                      HIQUAL.TCZZZ999.TAPECOPY(TCinvol)                          
  130.                                                                                 
  131.         The user may then inspect the JCL and possibly modify it before         
  132.     submitting it.  Note that it is the responsibility of the user to submit      
  133.     the JCL generated.  PCG will not submit it.  The turnaround time on a       
  134.     run sheet submitted to PCG is 24 hours.                                     
  135.                                                                                 
  136.         The other option is to create a control file that describes the data set
  137.     on the input volume.  This method will allow the user to immediately generate
  138.     and submit the JCL.  The format of the control file is:
  139.                                                                                 
  140.                        n DATA.SET.NAME RECFM LRECL BLKSIZE                      
  141.                                                                                 
  142.         'n' is either the file sequence number of the data set on the input     
  143.     tape or a '*'.  A '*' represents the file sequence number of the             
  144.     previous table entry plus one.                                              
  145.                                                                                 
  146.         The user may obtain the necessary file sequence and DCB information     
  147.     by running either a TINFO or requesting an OPRTINFO job on the input        
  148.     tape (see member TAPEINFO in SYS.MVS.UPDATE).  The difficult part may       
  149.     be in finding the full dsname of the input data sets.  Standard tape        
  150.     labels contain only the last 17 characters of the data set name and non     
  151.     labeled tapes have no data set names on the tape.  For security reasons     
  152.     the tape management system knows the full name of all data sets in its      
  153.     catalog, and it will not allow access to that data set unless the           
  154.     correct full data set name is given.  PCG has the authority to scan the     
  155.     tape management system catalog for the full data set name which users       
  156.     do not have.  If the input tape data sets are catalogued the full           
  157.     dsname is available in ISPF screen 3.4.                                     
  158.                                                                                 
  159.         In most cases if the TAPECOPY needs to be done immediately a user       
  160.     may build a control file and generate the JCL, but sometimes the user       
  161.     may not be able to find the full data set name or simply does not wish      
  162.     build a control file (especially in the case of tape with a large            
  163.     number of data sets).  In these cases they may submit a run sheet to        
  164.     PCG and the JCL will be generated for them.                                 
  165. EJECT                                                                           
  166.     PRIVATE TAPES                                                               
  167.                                                                                 
  168.         If the input tape is a private (EXPDT=98000) standard labeled tape      
  169.     the user must supply the data set name of the first file on the tape        
  170.     in the DSN parameter.  If the input tape is non labeled a CNTL             
  171.     parameter must be passed.                                                   
  172.                                                                                 
  173.        If TAPECOPY is run without a control file it will submit a job with      
  174.     job characters TI, which will pull the necessary information from the       
  175.     tape to create the JCL to copy the tape.  The actual tapecopy job has       
  176.     job characters TC.                                                          
  177.                                                                                 
  178.        TAPECOPY generates data set names for the output tape in the form        
  179.     HIQUAL.MIDQUAL.Fnnn.  HIQUAL defaults to the invoking userid or the         
  180.     user may pass it as a parameter.  The user must have RACF authority to      
  181.     write to that high level qualifier.  HIQUAL must be 6 or 7 characters.      
  182.     MIDQUAL is an optional but recommended parameter that describes the         
  183.     contents of the tape.  If the generated output data set names are
  184.     unsatisfactory, edit the generated JCL found in                             
  185.     HIQUAL.TCZZZ999.TAPECOPY(TCinvol).  Change the DSN in the SYSUT2 DD         
  186.     statements to the preferred data set name and submit the job.  Please
  187.     note that data set names must be unique.  If the user copies two tapes
  188.     and uses the same hi level qualifier and mid level qualifier the second
  189.     job run will have a return code of 0 but the output data sets will not
  190.     be catalogued because there is already a catalog entry with that name.                    
  191.                                                                                 
  192.         The user should not pass the FSQN parameter if a CNTL data set is       
  193.     specified.  That information is in the table.  The user should not pass     
  194.     the FSQN parameter if they wish to copy all the data sets on a tape.        
  195.     FSQN may be a list and/or range of file sequence numbers.  FSQN('9')        
  196.     FSQN('1,3,8') FSQN('1,4-7,9') are all valid examples.                       
  197.                                                                                 
  198.         Output data sets on library (99000) tapes are catalogued.  Output       
  199.     data sets on foreign (98000) data sets are not catalogued.                  
  200. EJECT                                                                           
  201.     EXAMPLES:                                                                   
  202.                                                                                 
  203.      1. If standard labeled library tape 7001 contains the data sets:           
  204.                                                                                 
  205.                             USERID.THESIS.DATA1                                 
  206.                             USERID.THESIS.DATA2                                 
  207.                             USERID.THESIS.DATA3                                 
  208.                                                                                 
  209.         The user submits a run sheet requesting:                                
  210.                                                                                 
  211.               TAPECOPY INVOL(007001) HIQUAL(USERID) MIDQUAL(THESISBK)           
  212.                                                                                 
  213.         PCG will run TAPECOPY which will place JCL in                           
  214.         USERID.TCZZZ999.TAPECOPY(TC007001) that will write a standard           
  215.         labeled library tape with the catalogued data sets:                     
  216.                                                                                 
  217.                             USERID.THESISBK.F001                                
  218.                             USERID.THISISBK.F002                                
  219.                             USERID.THESISBK.F003                                
  220.                                                                                 
  221.         when submitted.                                                         
  222.                                                                                 
  223.         If the user prefers, they may build a control file, run TAPECOPY,       
  224.         and submit the tapecopy job immediately.                                
  225.                                                                                 
  226.         Write USERID.TAPE.CNTL containing:                                      
  227.                                                                                 
  228.               * USERID.THESIS.DATA1 FB  80   3120                               
  229.               * USERID.THESIS.DATA2 FB  80   6240                               
  230.               * USERID.THESIS.DATA3 FBA 133  3192                               
  231.                                                                                 
  232.         Run TAPECOPY                                                            
  233.                                                                                 
  234.         TAPECOPY INVOL(007001) CNTL(USERID.TAPE.CNTL) OUTVOL(FOREIGN)            
  235.         OUTLBL(NL) OUTEXPDT(98000)                                              
  236.                                                                                 
  237.         This will create a foreign non labeled tape appropriate for mailing     
  238.         to another site.                                                        
  239.                                                                                 
  240.         If USERID.TAPE.CNTL contained instead:                                  
  241.                                                                                 
  242.               2 USERID.THESIS.DATA2 FB   80 6240                                
  243.               * USERID.THESIS.DATA3 FBA 133 3192                                
  244.                                                                                 
  245.         only the 2nd and the 3rd data sets would be copied.                     
  246.                                                                                 
  247.                                                                                 
  248.      2.  TAPECOPY INVOL(FOREIGN) INLBL(SL) INEXPDT(98000) DSN(DATA.SET.NAME)     
  249.          FSQN('1,3,4-9,23,45-60') OUTLST SUB                                    
  250.                                                                                 
  251.          Will copy the data sets specified in the FSQN from a foreign           
  252.          standard labeled tape to a standard labeled library tape.  The job
  253.          will automatically be submitted because of the SUB parameter, and a     
  254.          list of the the output tape will be written to:                        
  255.                                                                                 
  256.                           HIQUAL.TCZZZ999.OUTLST(FOREIGN)                       
  257.